home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 043a / ttkey100.zip / TTKEY.DOC < prev    next >
Text File  |  1993-03-07  |  8KB  |  191 lines
  1.                                                                               
  2.               ╔════════════════════════════════════════════════╗
  3.               ║    TTKEY -- Tiny Tafel to Keyword Converter    ║
  4.               ╚════════════════════════════════════════════════╝
  5.  
  6.                                Version 1.00
  7.                                   3/7/93
  8.  
  9.                               H. Rudy Ramsey
  10.                            Rams' Island Software
  11.  
  12.  
  13.  
  14. INTRODUCTION
  15.  
  16.    This morning, Cindy Scott pointed out on the FidoNet GENEALOGY echomail
  17.    conference that the BlueWave offline mail reader has a keyword-search
  18.    mechanism that can be used very effectively by genealogists.  Although
  19.    I am a registered user of BlueWave, the keyword-search feature had
  20.    escaped my attention.  I am very grateful that it was pointed out,
  21.    because its use will allow me -- with greatly reduced effort -- to
  22.    watch a large number of genealogical conferences for names of interest
  23.    to me.
  24.  
  25.    It immediately occurred to me that a simple Tiny-Tafel-to-keyword-file
  26.    converter would allow widespread use of this, and similar, search
  27.    capabilities with minimal effort.  Such a converter would also allow
  28.    genealogists to maintain a Tiny Tafel, and automatically update the
  29.    corresponding keyword files.
  30.  
  31.    Since I've gained a little time from learning about the keyword-search
  32.    capabilities of my offline editor, I decided to devote a small amount
  33.    of time to producing such a simple converter.  My total investment in
  34.    both program and documentation is about two hours, so it should be clear
  35.    that it's a simple, bare-bones converter.
  36.  
  37.    TTKEY is based on the COMMSOFT Tiny Tafel Specification 1.6, dated
  38.    11 December 1986, which is the latest such specification I have
  39.    seen.  If there are later specifications which alter the desired
  40.    behavior of the program, please let me know.
  41.  
  42.  
  43. SYSTEM REQUIREMENTS
  44.  
  45.    TTKEY requires an IBM PC or compatible computer.
  46.  
  47.  
  48. FILES IN THE PACKAGE
  49.  
  50.    TTKEY.DOC     This document.
  51.    TTKEY.EXE     The program itself.
  52.    FILE_ID.DIZ   A program description for use by BBSes and disk vendors.
  53.  
  54.  
  55. HOW TO USE TTKEY
  56.  
  57.    To see usage information for TTKEY, simply type
  58.  
  59.       TTKEY
  60.  
  61.    with no arguments.
  62.  
  63.    The command line for using the conversion facilities of TTKEY has
  64.    the form:
  65.  
  66.       TTKEY name [prefix]
  67.  
  68.    The "name" string is used to construct input and output filenames
  69.    with extensions of "TT" and "KEY", respectively.  Thus, the command
  70.  
  71.       TTKEY JONES
  72.  
  73.    causes TTKEY to read a Tiny Tafel file called JONES.TT, and to write
  74.    a corresponding keyword file called JONES.KEY.  Any surnames found
  75.    in the JONES.TT file will be extracted and written to JONES.KEY, in
  76.    a form such as:
  77.  
  78.       JONES
  79.       SMITH
  80.  
  81.    The optional "prefix" string can be used to prepend special characters
  82.    such as the "!", "@", and "#" characters used by BlueWave.  Thus, a
  83.    typical command line for producing a BlueWave keyword file might be
  84.  
  85.       TTKEY RAMSEY "#"
  86.  
  87.    This would extract surnames from RAMSEY.TT and produce a keyword file
  88.    of the form:
  89.  
  90.       #RAMSEY
  91.       #HENSLEY
  92.       #MADOLE
  93.  
  94.    A likely use of the TTKEY output file would be to place it in the
  95.    BlueWave directory, changing its filename to KEYWORDS.BW.  A more
  96.    sophisticated use would be to use it as a starting point for a
  97.    KEYWORDS.BW file that also contains other special words or phrases
  98.    of interest.  When the Tiny Tafel is updated, simply generate a new
  99.    *.KEY file and use a text editor to insert it in the appropriate
  100.    place in the KEYWORDS.BW file.
  101.  
  102.  
  103. TRY OUR INCONTEXT WORK ENVIRONMENT MANAGER
  104.  
  105.    If you're a fairly expert DOS-based computer user, you should take a
  106.    look at our shareware product, the InContext(TM) Work Environment
  107.    Manager.
  108.  
  109.       InContext(TM) is a complete Work Environment Manager for expert
  110.       PC users.  This program automates more aspects of the PC user's
  111.       work than any other product.  Designed by a PhD ergonomist,
  112.       InContext is based on fundamental principles of how people actually
  113.       work.  It allows you to organize your computer around your work
  114.       habits, rather than the other way around.
  115.  
  116.       On top of a unique, object-oriented DOS shell, InContext provides
  117.       well-integrated task/project planning and calendar management.
  118.       Tasks can be associated with directories, appropriate materials,
  119.       and procedures.  An extensive procedure language and smart application
  120.       launching make InContext a powerful platform from which to work.
  121.       Fast internal editor/viewer and archive viewers for ARC/ARJ/LZH/PAK/ZIP
  122.       are among an extensive array of features that round out this complete
  123.       Work Environment Manager.  ASP shareware.
  124.  
  125.  
  126. LICENSE FOR USE AND DISTRIBUTION
  127.  
  128.    The materials in this TTKEY package are copyrighted by Rams' Island
  129.    Software, but may be used without payment.  This provision gives you
  130.    the right to use the package freely, but does not give you the right
  131.    to sell it or to alter it in any way.
  132.  
  133.    This package may be distributed to others, provided the package
  134.    is clearly indicated as "free", and no representation is made that
  135.    rights to the package are being purchased.  A nominal disk copying
  136.    or download fee may be charged, but in no event may a charge in excess
  137.    of $5 U.S. be made for this purpose.
  138.  
  139.    In distributing this package, no alterations may be made to the files
  140.    within the package, nor may any file be deleted.  The file set may
  141.    be repackaged using a different compression algorithm.  The recommended
  142.    filename for this package is
  143.       TTKEY100.ZIP
  144.    where the filename extension "ZIP" may be replaced by the appropriate
  145.    extension for the archiver actually used.
  146.  
  147.    All rights not expressly granted here are reserved to Rams' Island
  148.    Software.
  149.  
  150. DISCLAIMER
  151.  
  152.    THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED ON AN "AS IS" BASIS.
  153.    RAMS' ISLAND SOFTWARE DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE,
  154.    WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED
  155.    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  156.    NEITHER RAMS' ISLAND SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN
  157.    THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE
  158.    FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF
  159.    THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF RAMS' ISLAND SOFTWARE
  160.    HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS.  THE
  161.    PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE
  162.    OF THE SOFTWARE.
  163.  
  164.    This agreement shall be governed by the laws of the State of Colorado
  165.    and shall inure to the benefit of Rams' Island Software and any
  166.    successors, administrators, heirs and assigns.  Any action or proceeding
  167.    brought by either party against the other arising out of or related to
  168.    this agreement shall be brought only in a STATE or FEDERAL COURT of
  169.    competent jurisdiction located in Douglas County, Colorado.  The parties
  170.    hereby consent to in personam jurisdiction of said courts.
  171.  
  172.  
  173. TECHNICAL SUPPORT
  174.  
  175.    This is a free program, and we make no promises regarding either
  176.    technical support or upgrades.  However, we are very responsive to
  177.    our users, and will likely act favorably on worthwhile suggestions
  178.    and bug reports.  Please feel free to contact us with any suggestions,
  179.    problem reports, etc.
  180.  
  181.    Rams' Island Software      
  182.    7644 Lakecliff                          _______
  183.    Parker, CO 80134-5904 (USA)        ____|__     |                (R)
  184.                                    --|       |    |-------------------
  185.    Voice: (303) 841-2848             |   ____|__  |  Association of
  186.    BBS:   (303) 841-6269             |  |       |_|  Shareware
  187.    CompuServe: 76244,324             |__|   o   |    Professionals
  188.                                    -----|   |   |---------------------
  189.    FidoNet:    1:104/333                |___|___|    MEMBER
  190.    RIME:        RAMSISLE          
  191.